home *** CD-ROM | disk | FTP | other *** search
/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / FILECOPY / MV.ZIP / MV.DOC < prev    next >
Encoding:
Text File  |  1991-07-11  |  12.5 KB  |  270 lines

  1.                                 MV 2.6
  2.  
  3.                            A Fast File Mover
  4.                     with wildcard shortcut support
  5.                      and directory removal option
  6.  
  7.                                   by
  8.                                Bob Eyer
  9.                              July 11, 1991
  10.  
  11.  
  12.      Syntax
  13.      ------
  14.  
  15.      MV SourceFile [TargetPath] [D]
  16.  
  17.      SourceFile
  18.         is a filename or a filespec specifying what is to be moved.  It
  19.         may  be  a  single  filename or wildcard, as well as a shortcut
  20.         such  as  '..\.',  '.',  'C:.',  or even 'C:' or a subdirectory
  21.         name.
  22.  
  23.      TargetPath
  24.         is  the destination where the files will be moved.  Again, this
  25.         parameter supports all  DOS  wildcard  shortcuts,  such  as  is
  26.         supported  by  DOS  COPY and DEL, and will detect DOS's default
  27.         path for a non-local drive, just as does COPY and DEL.
  28.  
  29.         In  the  event that TargetPath is not mentioned, MV will assume
  30.         that the target is the local (default) directory, as does COPY.
  31.  
  32.      D
  33.         an  optional  parameter  which,  if specified, will cause MV to
  34.         attempt to remove the subdirectory mentioned in SourceFile.
  35.  
  36.         If  D  is specified, a TargetPath MUST be mentioned; otherwise,
  37.         MV will interpret D as a target subdirectory.
  38.  
  39.  
  40.      New improvements in MV:
  41.      ----------------------
  42.  
  43.      -  Buffer size has been increased in  the  current  version,  thus
  44.         providing a small increase in the speed of MV's copy mode.
  45.  
  46.      -  A problem in all previous versions, that  the  date/time  stamp
  47.         was not duplicated on the target file when a file is moved to a
  48.         different drive, is now corrected.  The  current  version  will
  49.         preserve  the  date/time  and attribute stamps under copy mode,
  50.         just as it does under rename mode.
  51.  
  52.      -  The old attribute exclusionary condition has been liberalised.
  53.         In previous versions, move operations were  excluded  to  files
  54.         which  had the Read Only, System, or Hidden attributes.  In the
  55.         current version, the exclusion  has  been  narrowed  to  System
  56.         files.   As  a  result, it is now possible to move Read Only or
  57.         Hidden files, as well as Reset or Archive files.  However,  the
  58.         exclusion  against  System files remains in force.  The purpose
  59.         of this exclusion is to prevent the user from moving  Operating
  60.         System  files  from  his  boot  drive, an operation which would
  61.         require him/her to reformat or re-SYS,  and  reload  then  that
  62.         drive from backups before he/she could use it again.
  63.  
  64.      -  MV will now issue the message NOT COPIED for a move attempt  to
  65.         another  drive,  where insufficient space exists on that drive;
  66.         however, MV will pass control to the next file - and, if it  is
  67.         small enough to fit, that file will be moved normally.
  68.  
  69.      -  Source  files are now opened in SHAREd mode - which means that,
  70.         in local area networks where file sharing is  achieved  through
  71.         the  use  of  DOS  SHARE, an attempt of the user to move a file
  72.         which is in use by another user will  merely  pause  processing
  73.         slightly  or  cause  a  documented  return without a processing
  74.         halt.
  75.  
  76.  
  77.      Discussion
  78.      ----------
  79.      There  are  many file movers in the PD/shareware market; some much
  80.      smaller than MV  2.6,  others  considerably  larger  in  size  and
  81.      sporting    menus.    However,   the   smallest   of   the   genre
  82.      characteristically do not support DOS wildcard shortcuts, and only
  83.      a few of the larger ones offer consistent such support.   This  is
  84.      the  primary  reason why I wrote this little utility.  I got tired
  85.      of having to type 'MOVE *.* WORK' every time I wanted to  transfer
  86.      everything  in  the  local  directory to the WORK subdirectory.  A
  87.      command like that should go like this: 'MV  .   WORK'  saving,  in
  88.      principle,  two  keystrokes,  just  like  a COPY shortcut.  I also
  89.      found it tedious to change subdirectories  in  order  to  transfer
  90.      them  back  again.   I  wanted  it  to  function  just like a COPY
  91.      command, so that I could say things like 'MV WORK' and get all the
  92.      files back again without having to switch directories.
  93.  
  94.      MV requires video input only for confirm/no confirm on overwriting
  95.      a  file  and  for interrupting processing, where the user wants to
  96.      break execution immediately after moving the current file.  But in
  97.      both cases, console input  is  redirectable  (so  MV  can  be  run
  98.      remotely  through  a  communications  gateway)  and  uses just one
  99.      key-stroke (no ENTER key).  The Space Bar is used for interrupting
  100.      processing between files.   Y  (or  y)  is  used  for  confirm  on
  101.      overwrite.
  102.  
  103.      The best way to check out MV is to treat it exactly  like  a  COPY
  104.      command  on a series of files you can afford to lose; there should
  105.      be no difference, except for the file naming function of COPY:  MV
  106.      does  not  support  moving  a  source file to a target area with a
  107.      different base name specified on the commandline; and MV  uses  an
  108.      optional commandline parameter "D" to instruct the program whether
  109.      to attempt to remove the source directory.
  110.  
  111.      A short discussion of examples follows:
  112.  
  113.      Suppose  we  have  a file called ABC.EXE in directory \COMPILE and
  114.      we've been working in directory  \COMPILE\ABC  to  compile  a  new
  115.      version  of  ABC.EXE.  We now wish to update the COMPILE directory
  116.      version.  MV handles the job nicely:
  117.  
  118.      MV *.exe ..
  119.  
  120.      This command will direct the new EXE  file  to  be  moved  to  the
  121.      parent  directory  and  will  result  in  an  overwrite situation,
  122.      assuming the old version is  in  that  directory.   Hitting  Y  in
  123.      response  to  the  prompt  will  cause  the  overwrite.  The video
  124.      display will be:
  125.  
  126.      ..\ABC.EXE exists.  Overwrite? [Y/N]y
  127.      ABC.EXE      --> ..\ABC.EXE
  128.      1 file(s) moved
  129.  
  130.      Note the confirming message '1 file(s) moved'.  MV  always  issues
  131.      either  this confirmation with the number of files affected or the
  132.      message 'No file(s) moved' where no action was  taken,  say  where
  133.      all the source files are System files.
  134.  
  135.      Where the target file to be overwritten is Read Only, the  attempt
  136.      to overwrite will cause no action to be taken, and there will be a
  137.      message that the target file was not deleted.  The reason for this
  138.      is  that,  before  each overwrite, MV first attempts to delete the
  139.      target file, in preparation for the new write.  If it  cannot,  it
  140.      just returns with the appropriate diagnostic message.
  141.  
  142.  
  143.      Other examples
  144.      --------------
  145.      MV ABC.DOC C:LM          Moves ABC.DOC to the LM subdirectory
  146.                               of the default directory of C:
  147.  
  148.      MV c:lm\abc.doc          Moves ABC.DOC back from the LM
  149.                               subdirectory of the default path of C:
  150.                               (Notice that this example has no explicit
  151.                                target path, and is assumed to be the
  152.                                default directory.)
  153.  
  154.      MV XYZ C:\               Moves XYZ to the root directory of C:
  155.  
  156.      MV XYZ C:                Moves XYZ to the default directory of C:
  157.  
  158.      MV . ..\A                Moves everything in the current directory
  159.                               to  the  A  subdirectory  of  the current
  160.                               directory's parent.
  161.  
  162.      MV . ..\..\B             Moves everything in the current directory
  163.                               to the  B  subdirectory  of  the  current
  164.                               directory's grandparent.
  165.  
  166.      MV ..\..\B               Moves everything in the B subdirectory
  167.                               of the current directory's grandparent to
  168.                               the current directory.
  169.  
  170.      MV W . D                 Moves everything in the W subdirectory
  171.                               to the current directory and then removes
  172.                               the W subdirectory.
  173.  
  174.  
  175.      Errors
  176.      ------
  177.      MV thoroughly accounts for all errors and displays the appropriate
  178.      status message with each file on which the program operates.
  179.  
  180.      1.  No  parameters  on  the  command  line.  In this case, MV will
  181.          return a short help screen and DOS error level of 1.
  182.  
  183.      2.  No files satisfying the Source filespec.  MV will  return  the
  184.          message 'No such file(s)' and error level of 1.
  185.  
  186.      3.  Space bar is hit.  MV responds by  halting  with  the  message
  187.          'Processing interrupted' and error level of  1.   However,  MV
  188.          does not permit the spacebar halt to affect the integrity of a
  189.          pending file transfer.  MV holds the halt instruction from the
  190.          keyboard   buffer   until   the  pending  file  is  completely
  191.          transferred.
  192.  
  193.      4.  Source  file  has  the  System attribute.  MV takes no action,
  194.          issuing a 'NO ACTION - System file' message.
  195.  
  196.      5.  Copy/rename operation not complete or erroneous.   MV  returns
  197.          the message that the source file has not been copied, proceeds
  198.          to  delete  any  possible  remnant  in the target area, with a
  199.          message about no deletion if not complete,  and  then  returns
  200.          control to the next entry.
  201.  
  202.      6.  MV detects duplicate in target area.  See Example 1 above for
  203.          discussion.
  204.  
  205.  
  206.  
  207.      DISCLAIMER:
  208.      ==========
  209.      This program is circulated as freeware without  any  guarantee  or
  210.      warranty;  and  the  user,  by  downloading  this  program, or any
  211.      variant thereof or by receiving it or any of its versions  in  any
  212.      other  form, agrees to accept full responsibility for its use.  It
  213.      is therefore understood that the user accepts this program or  any
  214.      previous version as is.
  215.  
  216.      Bob Eyer                  The author may also be reached at
  217.      Compuserve [73230,2620]   ROSE MEDIA 416-733-2285 (Main Conf)
  218.      Toronto                   CMIX 416-277-2363 (Main Conference)
  219.      Canada                    CANADA REMOTE 416-629-7044 (IBM Conf)
  220.      -----------------------------------------------------------------
  221.      End of documentation.
  222.  
  223.  
  224.          ----------------end-of-author's-documentation---------------
  225.  
  226.                          Software Library Information:
  227.  
  228.                     This disk copy provided as a service of
  229.  
  230.                            Public (software) Library
  231.  
  232.          We are not the authors of this program, nor are we associated
  233.          with the author in any way other than as a distributor of the
  234.          program in accordance with the author's terms of distribution.
  235.  
  236.          Please direct shareware payments and specific questions about
  237.          this program to the author of the program, whose name appears
  238.          elsewhere in  this documentation. If you have trouble getting
  239.          in touch with the author,  we will do whatever we can to help
  240.          you with your questions. All programs have been tested and do
  241.          run.  To report problems,  please use the form that is in the
  242.          file PROBLEM.DOC on many of our disks or in other written for-
  243.          mat with screen printouts, if possible.  PsL cannot debug pro-
  244.          programs over the telephone, though we can answer questions.
  245.  
  246.          Disks in the PsL are updated  monthly,  so if you did not get
  247.          this disk directly from the PsL, you should be aware that the
  248.          files in this set may no longer be the current versions. Also,
  249.          if you got this disk from another vendor and are having prob-
  250.          lems,  be aware that  some files may have become corrupted or
  251.          lost by that vendor. Get a current, working disk from PsL.
  252.  
  253.          For a copy of the latest monthly software library newsletter
  254.          and a list of the 3,000+ disks in the library, call or write
  255.  
  256.                            Public (software) Library
  257.                                P.O.Box 35705 - F
  258.                             Houston, TX 77235-5705
  259.  
  260.                                 1-800-2424-PSL
  261.                              MC/Visa/AmEx/Discover
  262.  
  263.                           Outside of U.S. or in Texas
  264.                           or for general information,
  265.                               Call 1-713-524-6394
  266.  
  267.                           PsL also has an outstanding
  268.                           catalog for the Macintosh.
  269.  
  270.